BASIC LANGUAGE STATEMENTS 


These statements result in the computer performing an operation when the program is executed. 
They are normality entered with a preceding line number; however. a stalement may be used as a 


command by entering ft without a line number. 


CLS Ciear Scroon clears the display file that 
is the memory copy of the television 
picture and the te! vision screen. 
Format: CLS 
Example: line CLS 


DIM Deletes an array or string that has the in- 
dicated name it it previously existed and 
sets up an array of numbers or characters 
with K dimensions, 7, my. 


Format: [DIM letter (ny... 14) 
DIM lottor$ (nym) 


Examples: {ine DIM A( 10,5) 
fine DIM C ${5, 10) 


FOR Initiates a loop that repeats execution of 
ail instructions bounded by the NEXT 
Statement unt the automatically in- 
cremented of decremented “'step" 
variable attains the value exornm. 

Format: FOR Jotter = exprnm, TO 
exprnm, (STEP exprnms]" 
Example: line FOR A= 50 TO 100 STEP 10 


QOSUB Resuits in a branch to the indicated 
fine number. A RETURN statement causes 
a branch back to the instruction following 
the GOSUB. 
Format: GOSUB expvam 


Example: line GOSUB 500 


QOTO Causes an unconditional branch to the 
fine number, or if there is none, to the first 
tine after that. 


Format: GOTO expram 
Example: ine GOTO 500 


IF-THEN Causes the execution of a statement 
if the indicated expression is true, 
Format: IF expr THEN statement 
Exampie: line \F K= 41 THEN GO TO 200 


Suspends program execution and 
waits for the user to ontor a valve that will 
be assigned to the variable, 

Format: INPUT var 


Example: ine INPUT X 


LET Assigns a value or a string to the 
specified variable. 
Format: LET var = expr 
Example: ine LETX= 4° A +3°B 


LPRINT Sends a line of text to the printer. 
Format: LPRINT [AT 7,m TAB m) fist 
whore: n denotes fine, O<n=21 

m denotes colunn, Osms31 
Note: only column nurnber has any effect 
Example: tine LPRINT TAB 10,X, TAB 20, ¥ 


NEXT Terminates the loop initiated by a FOR 
statement 


Format; NEXT Jettor 
Example: line NEXT X 


PAUSE Stops computing and displays 
the display file for n frames (at 60 frames. 
per second) or until a key is pressed. 
Format: PAUSE exprnm 
where: O=<exprnm 565535 
Example: line PAUSE 500 


PLOT Blocks in the pixel at the indicated 
coordinates, 
Format: PLOT x-coordinate, y-coordinate 
where: 0s x-coordinate <63 
Osy-coordinales 43 
Example: Nine PLOT 10,15 


POKE Writes the value exprnm to the 
byte in storage at the indicated memory 
address. 


Format: POKE memadr, exprnm 


where: O<exprnm = 255 
Os memadr = 65535, 


Example: line POKE 16514,102 


PRINT Outputs values to the display tile for 
Gsplay on the television, 


Format: PRINT [AT n,m} [TAB m) [ist] { (a) | 
03] 


where: n denotes tine, 05521 

m denotes colum, Osms31 
AT Moves PRINT position to the line and 
column specified. 
TAB Moves PRINT position to the cot 
umn specified. 


LJ] COMMA Moves the beginning of the next 
Item to be displayed to position 16 on the pre- 


‘Sent line oF position 0 on Ine Next line, 
line. 


GL] SEMICOLON § Continues display im- 


mediately after previous Output displayed, 


Example; line PRINT X:¥;2 

RAND Slaternent that controts the random: 
ness of the RND function by starting RND 
off at the denoted place. 
Format: RAND [exprnm) 
whore: 1s exprnm = 65535 starts AND off 

at a definite place. 

when: expram = 0 RND starts based upon 
now long the television has been on. 
Example: fine RAND 35 

REM Nonexecutabdle statement that permits 
remarks to be placed in the statement 
Format: REM remark 
Example: line REM MY PROGRAM 

RETURN Results in a program branch to the 
‘statement immediately following the most 
recently executed GOSUB statement. 
Format: RETURN 
Example: line RETURN 

SCROLL Scrolls the display file up one line, 
losing the top line and making an empty 
tine at the bottom. 
Format: SCROLL 
Example: line SCROLL 


BASIC LANGUAGE STATEMENTS (cont.) 


STOP Halts execution with Report 9 code. 
CONT will resurne execution with the 


following line. 
Format: STOP 


Example: line STOP 


ass exprnm 
acs expinm 
ASN expram 
| ATH expmnm 
CHRS = exprnm 
CODE oxprs 
cos = exprnm 
=xXP exprnm 
1M KEYS var 
INT = oxprnm 
LEN expr 





UNPLOT Bianks out the pixel at the indicated 


coordinates. 
Format: UNPLOT x-coordinate, 
y-coordinate 
where: 0=*-coordinate = 63 
Osy-coordinate +43 
Example: line UNPLOT X.Y 


BASIC FUNCTIONS 

FUNCTION FORMAT AND DESCRIPTION 
Returns the absolute iN expinm —- Returns the natural 
value of a number, Jogarith of the 
Returns the Arccosine speciied resnioer 
of an angie of exprnm PEEK memadr Returns tho decimal 
radians. value of the specified 
Returns the Arcsine of Bemeny Jocahens 
an angle of exprnm Ll Returns 3.1415927, 


ragans. 


Returns the Arctangent 
of an angle of exprnm 
radians. 


Returns the character 
(string value) whose 
code is axprnm. O= 
exprnm = 255. 

Returns the code of the 
first character in the 
‘string o 0 If the string 
ts ormpty. 

Returns the Cosine of 
an angie of exprmm 
radians. 

Returns the base of the 
natural logarithm (e) 
raised to the specified 
power, 


Receives one character 


Returns the length of 
the specitied string. 


which is the circum: 
ference in inches of a 
circle one inch 


(which value it can 
take) and 1 (which it 
cannot). 


SQN = exprnm_~=——~Returns + 1 If exprnm 
és positive, — Vif 
negative, and 0 if its 
value is zero. 


SIN exprnm —- Returns the Sine of an 
angle of exprnm 
radians. 

SQR = exprnm_~—~Returns the square 
toot 

STR = exprnm = Converts & numeric 
value to a string. 


TAN = expynm Returns the tangent of 
an angie of exprnm 
radians, 


i 
i 
: 
a 
i 


VAL = expr$ Returns the numeric 
value of a string. 





CHARACTER GRAPHICS 


Permits characters to include letters, digits. 
Punctuation marks, and graphic symbols to be 
splayed in any of 704 distinct locations (32 
columns and 22 lines) on the screen. 


DISPLAY STATEMENT 
fine PRINT [ AT nm} [TAB m] {ist} {i"| 


Permits individual points to be blacked in or 
blanked out in any of 2616 distinct locations 
(64 x-coordinates and 44 y-coordinates) on 
the screen. 


DISPLAY STATEMENTS 
line PLOT x-coordinate, y-coordinate 
line UNPLOT x-coordinate, y-coordinate 


CODES MEANING 

° Successful completion or jump 
to tine number bigger than any 
existing. 
Control variable does not exist. 





‘STOP statement executed. 


Invalid argument to certain 
functions. 


Integer out of range. 





1 

2 An undefined variable has been The text of the argument of VAL 
used. does not form a valid numerical 

3 ‘Subscript out of range. expression. 

4 Nol enough room in memory. . Program interrupted by BREAK 

5 No more room on the screen. of INPUT line starts with STOP. 

6 Arithmetic overtlow. E bast used 

7 No corresponding GOSUB for a Program name provided is 
RETURN statement the empty string 

8 You have attempted an INPUT 
command (not allowed). 
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DISPLAY CONTROL NUMBER VALUED BOOLEAN RELATIONS 


OPERATIONAL RESULT 


REFERENCE GUIDE NOTATIONS AND | DATA ENTRY 


FORMAT CONVENTIONS 


KEY OR KEY COMBINATION 
This reference guide employs a standard scheme for presenting the general format of BASIC | 





language statements. The capitalization, punctuation and other conventions are listed below. 


[] Brackets indicate that the enclosed tems 
are optional, Brackets do not appear in 
the actual statements, 

{ } Braces indicate that a choice of one of 
the enclosed items is to be made. Braces 
do not appear in the actual statements, 

+» Etipses indicate that the preceding item 
may be repeated. Etlipses do not appear 
in the actual statements. 

Italics \talics indicate genetic terms. The 
programmer must supply the actual value 
of wording required. See Generic Terms 
and Abbreviations. 


Line number A line number is implied for all 
BASIC language statements entered in 
program mode. 

Punctuation Ali punctuation characters, 
including commas, semicolons, colons, 
quotation marks, and parentheses must 
appear as indicated. 

UPPER CASE Upper case letters and words 
Must appear exactly as indicated. Note 
that the Timex/Sinclair 1000 and 1500 
computers use only upper case. 


BASIC PROGRAMMING MODES 


IMMEDIATE Statement entered without a 
line number will be immediately executed 
by BASIC. Also known as command’ 
mode 


PROGRAM Statemeni(s) entered with line 
oats will be executed by AUN and 


GENERIC TERMS, ABBREVIATIONS, 
AND DEFINITIONS 


array A set of variables thal has the same 
name and that are distinguished by a 
number known as the subscript written in 
parenthesis after the name, An array can 
have 48 many values as there are 
elements, with each element of the array 
having @ separate value, 

cursor A display marker that indicates how 
the computer ts going to interprot the next 
key entered of occurrence of a syntax 
error. 

element Tho value assigned to a subscript. 

expr Any valid expression. 

expr Any valid siting constant, variable, or 
‘expression. 

exprnm Any numeric constant, variable, oF 
‘expression, 

format The structure of the BASIC command 
O¢ statoment. 

fetter Any one of the 26 alphabetic 
characters. y 

Jetter$ Any one of the 26 alphabetic charac- 
tors followed by a dollar sign ($), which 
signities a string name. 

line A BASIC program line number between 
1 and 9999, 


Mat A list of constants, variables, or 
expressions 
m_ A column on the screen between © and 31 
used to position where characters ang 
graphic symbols are to be displayed. 
memadr A memory address reterenced by a 
numenc expression, variable, of constant 
fn Aline on the screen between 0 and 21 
used to position where characters and 
graphic symbols are to be displayed. 
scalar A variable that has only one valve at 
a given time. 
statement A BASIC language equivalent of 
an English sentence. 
subscript A number or numeric expression 
which, when evaluated, identities a par- 
ticular element in an array, 
x-coordinate The position of & pixel with 
tespect to the left-hand column of the 
screen, The specified value must be 
between © and 63, 

‘The position of a pixel with 
respect to the bottorn of the screen. The 
peter value must be between © and 
4 

var Numeric or siting variable. 


CURSOR DISPLAY MODES 


[3 Keyword (token) mode. Permits the 
keyword printed above the key to be 
displayed when the key is pressed or a 
line number to be entered, 

Letter mode. Means the computer will 
ingerpret any key pressed as the letler 
of number (large symbol) on the key. 
The large symbol will be displayed 
when the key is pressed, 

T@_ Function mode. Mode eel by 
simultaneously HIFT and 
FUNCTION kyo. Perm Permits the words under 
the keys to be cisplayed when key Is 
pressed. 


Graphics mode and Inverse mode, Mode 
entered by simultaneously pressing SHIFT 
land 9 keys. Permits graphics characters 
on the key to be displayed when the shift 
key and key containing the gaene symbol 
are pressed. In the inverse mode, 
characters show up as white on black 
background, Exit graphics mode by 
pressing SHIFT and 9 keys. 

El syntax error marker. Denotes an 
unacceptable format for the data that was 
entered, 
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KEYWORD ee, eer raerer. 


through 
Can lered as individual characters 
SHIFT CHARACTER Any cha) naracter printed 
at the top of key in red on the TS 1000, 
and at lower left in biack on the TIS 1500 


desired shift character 


GRAPHIC SYMBOL A graphic symbol can 
be entered by first pressing SHIFT and 9 


keys simultaneously to obtain graphics 
guwcsex td Voenrees Set ae 
appropriate containing graphic 
painL Esa geprica oes ty poem 
‘SHIFT and 9 key 
FUNCTION Cperation request entered by 
first pressing SHIFT and FUNCTION keys 
simultaneously to obtain function mode 
cursor J. Then press key showing 
esired function below it. Function will be 
entered and cursor changes back to 


DATA ENTRY AND CURSOR DISPLAY MODES 


Pross keys). 
Pross key. 
Press SHIFT plus key. 


Press SHIFT plus 
FUNCTION key. 


Press SHIFT plus key. 
Pross SHIFT plus 9. 


Press SHIFT plus key. 


Press key 
Press SHIFT plus 9. 


Line number or keyword 
Letter 

Shift character 
FUNCTION mode 


Designated function 
GRAPHICS Mode 
Graphic symbot 
lnverse video letter 
Exit Graphics mode 








DISPLAY INDICATORS 


Eh bas: tee entero 


FEpOFT OF Current ine 


Last Line Entered Previous program ine 
ENTERed by pressing ENTER key, 
Current Line Program tine you are entering. 
Once ENTERed, current fine becomes last 
line entered. 
Report Two digits separated by siash (/) of 
form: 
nim 
013 a Code that reporis success or failure 
of operation 
M Genctes last thing Gone was line m, 


SHIFT and © 
SHIFT and 1 
SHIFT and 5 (when editing) 
SHIFT and 6 
SHIFT and 7 
SHIFT and 8 (when editing) 


SHIFT and 9 
SHIFT and FUNCTION 
ENTER 


Deletes the character or 
imenediately to the left of the cursor, 


Moves the last line entered to the 
Dottom of the screen for EDITING. 


Moves the cursor to the left one 
position, 


Moves the last line entered cursor 
down one position. 

Moves the last line entered cursor EJ 
UP One position. 

Moves the cursor to the right one 
positon. 

Causes Graphics mode entry or exit. 
Causes Function mode entry. 

Enters present ling into memory or 
retrieves program isting, 





VARIABLE NAMING CONVENTIONS 


Scalar Variable format F {S} where 
First character must be a letter. 


Second character must be dollar sign (S) 


it string variable; otherwise may be 
letter oF digit. 


Name length: one letter and dollar sign ($) 
it string variable; any number of letters 


and digits if regular variable, 


Arey MER ARRAY format 


Letter ( exprnm ) 
Letter ( expinm, exprnm ) 
STRING ARRAY format 
Lotter$ (oxpmm,, { exprmm, }) 
where: exprnm, Getines number of 
‘elements in the array 


exprnm; delines the length ot 
the string array in characters. 


ARITHMETIC OPERATORS 


Less than or equal to 
Greater than 
Greater than or equal to 





STRING OPERATORS 


Stlcing Obtains a substring from a string. 
Format: expr$ ((start) TO {finish)) 
Example: “ABCDEF" (2 TO 5)= 

Concatenation Joins togetter two strings. 
Format: expr$, + expr$2 


Example: "BUG" + "OFF" = “BUGOFF" 
Parentheses Defines slicing operation result 


Examples: “ABC” + “DEF” (1 TO 5) 
"ABCDE” 





("ABC” + “DEF") (1 TO 2)= AB” 





X$ AND Y 


Xit ¥ is nomzero, 
Olt ¥is zero. 


it ¥ is non-zero, 
it ¥ is zero, 


1 
x 
Oi X is non-zero, 
Tit X is zero, 


STRING AND NUMBER VALUED BOOLEAN RELATIONS 


xs if ¥ is non-zero, 
(empty string) it ¥ is zero, 





CASSETTE OPERATIONS 


1. Connect recorder to computer 
“ear ear,” 


5. Receive report of 0/0 on screen when. 
loading completed successtully, 


2 Odtain Cursor on your screen. 6. Turn tape recorder OFF. 
3 Key in LOAD" “or LOAD “Program 7. Press RUN and ENTER to use program 
4, Star cassette recorder by pressing 

PLAY on recorder and then pressing 

ENTER on keyboard, 

PROGRAM SAVING 
1, Connect recorder to computer 4. Start the recorder on RECORD. 
“mic to mic,’” 5. Press ENTER. 
2. Position tape. 6. Receive report of 0/8 on screen when 
3. Type SAVE “Program name" ‘saving successfully completed. 
SYSTEM COMMANDS 


These commands result in the computer performing an operation at the system level. Tha com 
mands are normally entered without a line number, however, they can be used in a program by 


prefixing the command with a fine number. 


BREAK Suspends program execution 
Resumod by pressing SPACE key. 
Format; BREAK 

CLEAR Sets all variables back to zero. 
Format: CLEAR 

CONT CONTinues execution at the next in- 
‘struction following a BREAK or STOP. 
Format: CONT 

COPY Prints the contents of the television 
screen on the printer. 

Format: COPY 

FAST Starts fast mode, in which the display 
file is displayed only at the end of the pro- 
gram, of while INPUT data is being typed 
im, oF during a pause, 

Format: FAST 

LIST Displays up to twenty-two lines or a 
‘Specified portion of the program currently 
in memory, Starting at the indicated line, 
be makes that fine number the current 
Format: LIST | tine | 

LUIST Lists all (or 8 specitied portion) of the 
Program currently in memory on the 
printer, starting at the indicated line, 
Format: LUST | ine | 


LOAD Loads the first program or a specified 
program PARResetie in memory. 
Format: 
LOAD ** Program name ‘** 
NEW Deletes the current program and all 
variables from memory. 
Format: NEW 
RUN Clears all variables and executes the 
Current program in memory. If a line 
number is specified, execution com: 
Mences at that line number; otherwise ox: 
ecution begins at the first ine in the 
program. 
Format: RUN | tine | 
SAVE Saves the program currently in mem: 
Ory On cassette with the designated pro- 
gram name. 
Format: SAVE '* PROGRAM NAME ** 
SLOW Puts the computer into compute and 
display mode, in which the display file is 
Gisptayed continuousty and computing is 
Gone during the spaces at the top and bot- 
tom of the picture. 
Format SLOW 


